===========================================
| Raptor007's Falcon 4 to X52 Pro Utility |
| Version 1.3 (2009-10-24)                |
|                                         |
| http://www.raptor007.com/               |
| blair@datapro.net                       |
===========================================


This program was written by Raptor007 (Blair Sherman).  Email me or find my thread on
saitekforums.com if you find a bug or would like additional features.  I have plans
for additional features, so keep watching for updated versions.

This program would be nothing without the F4SharedMemory library, by Lightning of
viperpits.org.  Thanks for the excellent work!

Special thanks to Darkcloud of saitekforum.com for pointing me in the right direction.


IMPORTANT NOTE
--------------
Keep the files from this archive together!  If F4SharedMem.dll is removed, this
utility will NOT function.  You'll also need Saitek's full software package installed
(not just the drivers).  This utility probably also requires .NET Framework 2.0, but
then again, so does the Saitek software.


GETTING STARTED
---------------
To use this utility, simply open the exe, select the settings you want, and hit Start.
Then open Falcon 4 and enjoy!

This utility will stop responding once you hit Start; you'll have to open Falcon 4 to
wake up the program, then exit Falcon 4 to get it back to it's editable status.  In a
future verison, I may fix this with multi-threading.


SETTING UP MFD PAGES
--------------------
It's pretty simple, really.  Just pick the number of pages you'd like, then for each
page, pick the data you'd like to see on that page (up to 3 lines) from the drop-down
boxes.

The text box to the left of each drop-down is the label for that data; keep these
short since you'll only have 16 characters total per line (label + info).

The page that is selected in the utility when you hit Start will be the default page
displayed once you start Falcon 4.  You can use the throttle's Page Up/Down wheel
to scroll through the pages during the game.


SETTING UP LEDS
---------------
For each LED, you'll want to set its default color first.  If you choose "Unchanged",
the utility will never send any data to the joystick for that LED, and thus cannot be
configured for condition-based coloring.

You can configure up to 9 conditions (in addition to the default state).  First pick
the condition you'd like to check for, then the color for that condition, and finally
if you'd like the LED to blink.

The order of execution is:
* Condition 1
* Condition 2
* ...
* Default Color

So if both the first and second conditions are true, the LED will use the color and
blink rate specified for Condition 1.  If all conditions are false, the default
color will be displayed.


NOTE FOR UPGRADING
------------------
If you'd like to keep your settings from an older version, get rid of the settings.cfg
included with this archive and put in your old settings.cfg.  The utility will import
the settings at program start and then re-save as a v1.3 settings file when you exit.


CHANGES: v1.3 (2009-10-24)
--------------------------
* Added support for BMS3 and BMS4 formats.
* Changed minimum MFD pages to 1, because I can only control LEDs on my MFD pages.
* Now keeps track of all Saitek DirectOutput devices and lets you select one.
* Automatically selects X52 Pro if there are multiple Saitek DirectOutput devices.
* Many new MFD options, such as groundspeed, vector in air, and wind calculations.
* Fixed a minor bug that would cause it to jump to MFD page 1 unnecessarily when
  setting the number of MFD pages.
* Increased the height of some drop-down boxes to make them easier to use.

CHANGES: v1.2 (2009-04-13)
--------------------------
* Tweaked code to compile with Lightning's F4SharedMemory v2.0.0.0.  Hopefully this
  will improve OpenFalcon compatibility.
* Added an artificial horizon option for the MFD.
* No longer deinitializes DirectOutput when Falcon 4 exits.  Now you should not
  have to quit and reopen the utility for multiple Falcon 4 runs.
* Fixed the working directory bug; auto-save now works after manual load/save.
* Fixed a potential memory leak.
* Fixed a bug that would forget your selected MFD page if it was the last.
* Fixed a bug that would forget MFD labels sometimes.

CHANGES: v1.1 (2008-12-17)
--------------------------
* Rewrote LED code entirely, to allow multiple conditions and blinking lights.
* Added many more possible conditions for LEDs, like caution lights and RWR data.
* Added RWR and LightBit options for MFD.
* Removed "Engine Fire" conditions because I never could get it to work.
* Added save/load buttons for settings, so you can easily keep multiple setups.
* Implemented code to allow v1.1 to read settings from v1.0.
* The included settings.cfg has been updated for better MFD and LED utilization.

CHANGES: v1.0 (2008-10-31)
--------------------------
* Initial release.
